home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glpolygonstipple.z / glpolygonstipple
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  70 lines
  1.  
  2.  
  3.  
  4. ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee((((3333GGGG))))           OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee           ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee - set the polygon stippling pattern
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee( const GLubyte *_m_a_s_k )
  14.  
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _m_a_s_k  Specifies a pointer to a 32 x 32 stipple pattern that will be
  18.            unpacked from memory in the same way that ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss unpacks
  19.            pixels.
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      Polygon stippling, like line stippling (see ggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee), masks out
  23.      certain fragments produced by rasterization, creating a pattern.
  24.      Stippling is independent of polygon antialiasing.
  25.  
  26.      _m_a_s_k is a pointer to a 32 x 32 stipple pattern that is stored in memory
  27.      just like the pixel data supplied to a ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss call with _h_e_i_g_h_t and
  28.      _w_i_d_t_h both equal to 32, a pixel format of GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX, and data type
  29.      of GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP.  That is, the stipple pattern is represented as a 32 x 32
  30.      array of 1-bit color indices packed in unsigned bytes.  ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee
  31.      parameters like GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____SSSSWWWWAAAAPPPP____BBBBYYYYTTTTEEEESSSS and GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT affect the
  32.      assembling of the bits into a stipple pattern.  Pixel transfer operations
  33.      (shift, offset, pixel map) are not applied to the stipple image, however.
  34.  
  35.      To enable and disable polygon stippling, call ggggllllEEEEnnnnaaaabbbblllleeee and ggggllllDDDDiiiissssaaaabbbblllleeee with
  36.      argument GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN____SSSSTTTTIIIIPPPPPPPPLLLLEEEE. Polygon stippling is initially disabled. If
  37.      it's enabled, a rasterized polygon fragment with window coordinates x
  38.                                                                           w
  39.      and y  is sent to the next stage of the GL if and only if the
  40.           w
  41.      (x  mod 32)th bit in the (y  mod 32)th row of the stipple pattern is 1
  42.        w                        w
  43.      (one).  When polygon stippling is disabled, it is as if the stipple
  44.      pattern consists of all 1's.
  45.  
  46. EEEERRRRRRRROOOORRRRSSSS
  47.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee is executed between
  48.      the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  49.  
  50. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  51.      ggggllllGGGGeeeettttPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee
  52.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN____SSSSTTTTIIIIPPPPPPPPLLLLEEEE
  53.  
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee, ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee, ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                                                         PPPPaaaaggggeeee 1111
  67.  
  68.  
  69.  
  70.